home *** CD-ROM | disk | FTP | other *** search
/ TPUG - Toronto PET Users Group / TPUG Users Group CD / TPUG Users Group CD.iso / CRS / crs52.d81 / unix311b.sfx / intro.2 < prev    next >
Text File  |  1990-02-12  |  20KB  |  463 lines
  1.  
  2.  
  3. ╒NIX 128 V3.10 ═ANUAL           15 ╩ANUARY 1992                          ╨AGE 8
  4.  
  5.  
  6. 12.  ╔NTRODUCTION TO NROFF.
  7.  
  8. NROFF IS A TEXT FORMATTING PACKAGE THAT IS "MOSTLY" COMPATIBLE WITH PLAIN NROFF
  9. AND  TROFF  SOURCE  FILES  (NO  MACROS ARE INCLUDED WITH THIS RELEASE FOR TABLE
  10. (TBL) OR EQUATION (EQN) PROCESSING).   NROFF  IS  NOT  A  "WORD  PROCESSOR"  OR
  11. "EDITOR", BUT A PASS-THRU TEXT FORMATTER.  ┘OU MUST ENTER TEXT ON ANY EDITOR OR
  12. WORD PROCESSOR (EMACS IS FINE) AND THEN TYPE  % NROFF -P FILE TO PRINT IT OR  %
  13. NROFF  -V  FILE  TO PREVIEW IT. NROFF PROVIDES THE POWERFUL FEATURES ASSOCIATED
  14. WITH MANY WORD PROCESSORS.
  15.  
  16. 12.1  ├OMMAND ╠INE ╧PTIONS:
  17.  
  18. NROFF MAY BE INVOKED WITH SEVERAL COMMAND-LINE OPTIONS IN THE FORMAT:
  19.     % NROFF (OPTIONS) FILENAME
  20. ╘HE OPTIONS ARE:
  21.       -I  ╔NTERACTIVE FORMATTING SETUP FIRST.
  22.       -V  ╓IDEO PREVIEW ONLY
  23.       -P  ╨RINT DOCUMENT
  24.       -╙  ╒SE MY OWN SYMBOL TABLE INSTEAD OF 'NROFF.TBL.'  ┼XAMPLE:  -╙MYTABLE
  25.  
  26. ┴ COMMAND LINE MIGHT LOOK LIKE: % NROFF -I -╙MYTABLE -P THISFILE.
  27. ╘HE NROFF COMMAND TAKES A SINGLE DOCUMENT FILENAME,  WHICH  MUST  BE  SPECIFIED
  28. LAST ON THE COMMAND LINE.
  29.  
  30. 12.2  ╞ORMATTING ├OMMANDS:
  31.  
  32. ┴LL FORMATTING COMMANDS MUST BEGIN WITH A PERIOD (.) THAT IS AT  THE  FAR  LEFT
  33. (FIRST COLUMN) OF THE SOURCE DOCUMENT.   ┴ COMPLETE LIST OF FORMATTING COMMANDS
  34. CAN BE VIEWED BY TYPING % MORE NROFF.HLP FROM THE SHELL, OR FROM  WITHIN  EMACS
  35. BY TYPING ┼╙├-╪ ╬╥╧╞╞.
  36.  
  37.  
  38. 13.  ╔NTRODUCTION TO THE AS ┴SSEMBLER ─EVELOPMENT ╨ACKAGE
  39.  
  40. AS IS THE ╒NIX 128 8510 ASSEMBLER.  ╔T TAKES A SINGLE  SOURCE  FILE,  PROCESSES
  41. THE  ╒NIX  128 EXTENSIONS, WRITES AN OBJECT FILE (*.O) THAT CONTAINS ONLY VALID
  42. 8510 ASSEMBLER OPCODES / OPERANDS, THEN CONVERTS THE OBJECT  FILES  AND  WRITES
  43. THE ├128 MACHINE LANGUAGE FILE 'A.OUT.'
  44.  
  45. ╘HE FIRST TWO BYTES OF 'A.OUT' CONTAIN THE START ADDRESS OF THE CODE (WHERE  IT
  46. IS LOADED) AND THE REST OF THE FILE CONTAINS THE MACHINE LANGUAGE CODE.
  47.  
  48. 13.1  ╠ANGUAGE ┼XTENSIONS:
  49.  
  50. ╘HE EXTENSIONS TO STANDARD ASSEMBLER ARE AS FOLLOWS:
  51. 1.  ╘HE FIRST LINE OF ANY ASSEMBLER  SOURCE  CODE  MUST  BE  THE  WORD  'START'
  52. FOLLOWED BY EITHER A DECIMAL NUMBER OR A '$' AND A HEXIDECIMAL NUMBER.  ╘HIS IS
  53. THE START ADDRESS OF THE CODE WHICH IS  WRITTEN  DIRECTLY  TO  'A.OUT.'   ╔F  A
  54. 'START' LINE IS NOT FOUND, AN ERROR WILL BE PRINTED, AND THE COMPILER WILL HALT
  55. AND CATCH FIRE.
  56.  
  57. 2.  ╧NE OR MORE LINES MAY BE GIVEN THAT BEGIN WITH THE  WORD  'INCLUDE'  AND  A
  58. SOURCE  FILENAME THAT CONTAINS VALID MACRO DEFINITIONS (SEE 4).  ╘HE PURPOSE OF
  59. THIS STATEMENT IS SIMILAR TO THE ├ #INCLUDE <LIBRARY.H>: TO INCLUDE  MACROS  OF
  60. STANDARD  CODE.   ┴N INCLUDE FILE, 'STDLIB.I', IS GIVEN WITH THIS PACKAGE AS AN
  61. EXAMPLE.  ┼XAMPLE:  INCLUDE STDLIB.I
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69. ╒NIX 128 V3.10 ═ANUAL           15 ╩ANUARY 1992                          ╨AGE 9
  70.  
  71.  
  72. 3.   ┴  DATA  SECTION  MAY BE GIVEN, SO THAT YOU MAY LABEL COMMON CONSTANTS.  ┴
  73. DATA SECTION CONSISTS OF THE WORD 'DATA' ON ITS OWN LINE, FOLLOWED  BY  ONE  OR
  74. MORE DATA LINES, AND FOLLOWED BY THE WORD 'ENDD' (END-DATA) ON ITS OWN LINE.  ┴
  75. DATA LINE CONSISTS OF A DATA LABEL, THE WORD 'EQU', AND A DECIMAL  VALUE  OR  A
  76. HEXIDECIMAL VALUE PRECEEDED BY A '$'
  77. ┼XAMPLE:
  78.    DATA
  79.      ZERO EQU $00
  80.      TWO EQU 2
  81.    ENDD
  82. ╫HEREVER THE NAMES 'ZERO' OR 'TWO' ARE ENCOUNTERED, THEY ARE REPLACED WITH  THE
  83. APPROPRIATE DATA VALUE.
  84.  
  85. 4.  ═ACROS ARE UNITS OF CODE THAT ARE GIVEN A NAME.  ╘HEY ARE DEFINED ONCE, AND
  86. EXPANDED  WHEREVER THE MACRO NAME IS FOUND.  ┴ MACRO DEFINITION BEGINS WITH THE
  87. WORD 'MACRO', A SINGLE SPACE, AND THE MACRO NAME.  ╧NE OR MORE LINES  OF  VALID
  88. 8510  SOURCE  CODE ARE GIVEN ON SEPARATE LINES, AND THE WORD 'ENDM' (END-MACRO)
  89. IS GIVEN TO CONCLUDE THE MACRO DEFINITION.
  90. ┼XAMPLE:
  91.    MACRO FOO           (START A MACRO NAMED FOO)
  92.      LDA #$00
  93.    ENDM                (END OF THIS MACRO)
  94. ╫HENEVER THE NAME 'FOO' IS ENCOUNTERED IN THE SOURCE CODE, IT IS REPLACED  WITH
  95. THE  LINE  'LDA #$00'.  ═ACROS CANNOT BE GIVEN PARAMETERS.  ╙TANDARD MACROS ARE
  96. USUALLY USED FOR SYSTEM CALLS SUCH AS SETTING FAST MODE OR CLEARING THE SCREEN.
  97.  
  98. 5.  ├OMMENTS CAN BE GIVEN ON SEPARATE LINES  BY  BEGINNING  THAT  LINE  WITH  A
  99. SEMICOLON (;).  ┼XAMPLE:
  100.    ;╘HIS IS A COMMENT
  101.  
  102. 6.  ┴NY LINE MAY BE GIVEN A NAME BY WHICH IT CAN BE REFERRED.  ╘HIS REMOVES THE
  103. TEDIUM  OF KEEPING TRACK OF ADDRESSES FOR JUMPS AND BRANCHES.  ╘HE NAME MUST BE
  104. FOLLOWED IMMEDIATELY BY A COLON (:).  ┼XAMPLE:
  105.  LINE:  LDX #ZERO
  106.         STA $0400,X
  107.         JMP LINE
  108.  
  109. **╫┴╥╬╔╬╟**  ┬E VERY CAREFUL NOT TO USE VALID OPERAND NAMES  FOR  LINE  LABELS,
  110. DATA LABELS OR MACRO NAMES.  ╘HE PREPARSER WILL REPLACE ALL OCCURENCES OF LABEL
  111. NAMES WITH THE APPROPRIATE DATA.  (╞OR EXAMPLE, IF YOU LABEL A LINE WITH  JSR:,
  112. EVERY  TIME  YOU USED JSR IN YOUR PROGRAM IT WILL BE REPLACED BY THE ADDRESS OF
  113. THE LINE TO WHICH THE LINE LABEL REFERS!)
  114.  
  115. 13.2  ├OMMAND ╠INE ╧PTIONS:
  116.       AS CAN BE INVOKED WITH  SEVERAL  DIFFERENT  OPTIONS  FROM  THE  ╒NIX  128
  117. COMMAND LINE:
  118.    % AS -H           :╨RINTS A HELP SCREEN.
  119.    % AS -D BEG END   :─ISASSEMBLES MEMORY FROM BEG TO END
  120.    % AS -V BEG END   :╓IEWS MEMORY FROM BEG TO END
  121.    % AS FILENAME     :╨ARSES 'FILENAME' --> 'FILENAME.O' --COMPILES--> 'A.OUT'
  122.  
  123. AS ACCEPTS ALL VALID 8510 OPCODES, AND THE FOLLOWING RESERVED KEYWORDS:
  124.    START   MACRO   ENDM    DATA    ENDD    INCLUDE EQU
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133. ╒NIX 128 V3.10 ═ANUAL           15 ╩ANUARY 1992                         ╨AGE 10
  134.  
  135.  
  136. 13.3  ╟ENERAL ╬OTES:
  137. 1.  ╒SE ALL LOWER CASE FOR KEYWORDS AND OP-CODES, AND USE A SINGLE SPACE
  138.        BETWEEN OP-CODES AND OPERANDS.  
  139. 2.  ╘HERE IS A LIMIT OF 1500 LINES OF SOURCE CODE (255 CHARACTERS PER LINE)
  140. 3.  ╘HERE IS A LIMIT OF 75 MACROS OF 50 LINES (255 CHAR/LINE) EACH.
  141. 4.  ╘HERE IS A LIMIT OF 100 UNIQUE LINE LABELS.
  142. 5.  ╘HERE IS A LIMIT OF 100 DATA ITEMS IN THE DATA SECTION.
  143.  
  144.  
  145. 14.  ╨ROGRAMMING IN ┬┴╙╔├ ╒NDER ╒NIX 128.
  146.  
  147. ╔T IS QUITE FEASIBLE TO WRITE ┬┴╙╔├ 7.0 CODE USING EMACS.  ╘HERE ARE NO SPECIAL
  148. FEATURES  INCLUDED  FOR  WRITING  ┬┴╙╔├ CODE UNDER EMACS.  ╘O CONVERT AN EDITOR
  149. (╙┼╤) FILE TO ┬┴╙╔├ FORMAT,  SIMPLY  TYPE  '%  BASIC'.   ╘HE  ┬┴╙╔├  CONVERSION
  150. UTILITY  WILL  LOAD  THE  REQUESTED  FILE  INTO  MEMORY,  WHERE YOU CAN RUN IT.
  151. ╥EMEMBER TO SAVE THE FILE AFTER THE CONVERSION IS COMPLETE (╫HEN THE CONVERSION
  152. COMPLETES,  EITHER  A  SYNTAX  ERROR WILL OCCUR OR THE DISK DRIVE WILL HALT AND
  153. YOU'LL NEED TO PRESS ╥╒╬/╙╘╧╨ - ╥┼╙╘╧╥┼; EITHER IS NORMAL  -  YOUR  PROGRAM  IS
  154. SAFELY IN MEMORY.)
  155.      ╘O CONVERT A ┬┴╙╔├ PROGRAM TO ╙┼╤ FORMAT FOR EMACS, LOAD THE FILE NORMALLY
  156. FROM ┬┴╙╔├ THEN TYPE:
  157.            ╧╨┼╬ 5,8,4,"0:SEQ-FILENAME,S,W"
  158.            ├═─5:╠╔╙╘
  159.            ╨╥╔╬╘#5
  160.            ├╠╧╙┼ 5
  161.  
  162.  
  163. 15.  ╔NTRODUCTION TO THE EMACS ╘EXT ┼DITOR.
  164.  
  165. ┼MACS IS A POWERFUL TEXT EDITOR FOR USE UNDER ╒NIX 128.  ╔T IS NOT  A  DOCUMENT
  166. FORMATTER  OR  'WORD  PROCESSOR'-  THE MOST ADVANCED TEXT PREVIEWING FEATURE IS
  167. WORD-WRAP.  ╘EXT SHOULD BE  PASSED  TO  NROFF  FOR  FORMATTING  (LINE  SPACING,
  168. COLUMNS, JUSTIFICATION ETC.)
  169.  
  170. ┼MACS ALLOWS UP TO 700 LINES OF TEXT (OF 80 CHARACTERS / LINE).  ╔T  LOADS  AND
  171. SAVES  ╙┼╤  TYPE  FILES  THAT  ARE  COMPATIBLE WITH MOST OTHER WORD PROCESSORS.
  172. ┼MACS ALSO FEATURES ─ISK┼D, TO ENTER ├┬═-─╧╙ COMMANDS.  ╔T HAS HELP SCREENS FOR
  173. ITSELF  AS  WELL AS A COMMAND REFERENCE FOR WRITING NROFF SOURCE FILES.  ╔T HAS
  174. MULTIPLE TEXT EDITING FEATURES LIKE SETTING AND COPYING REGIONS, 'KILLING'  AND
  175. 'YANKING' LINES OF TEXT, COMMANDS TO MOVE TO THE START AND END OF LINES, UP AND
  176. DOWN BY SCREENS, AND COMMANDS TO MOVE TO THE START AND END OF TEXT.  ╞ILES  CAN
  177. BE INSERTED INTO THE TEXT.  ╘HERE IS FONT SUPPORT, AND 2 PARTIAL FONTS (ONE FOR
  178. SPECIAL ╨OLISH CHARACTERS AND ONE FOR  THE  ╥USSIAN  (CYRILLIC)  ALPHABET)  ARE
  179. INCLUDED.
  180.  
  181. 15.1  ╥EGIONS:
  182.       ┴ REGION IS DEFINED AS ALL THE TEXT IN BETWEEN THE 'MARK' AND THE CURRENT
  183. CURSOR  POSITION.   ┴ MARK IS SET BY TYPING (├OMMODORE) (╙╨┴├┼).  ╧NCE A REGION
  184. IS DEFINED, YOU CAN:
  185.         ├╧╬╘╥╧╠-C : COPY REGION AS KILL.  ╘HIS ALLOWS YOU TO  COPY  THE  REGION
  186. INTO THE KILL BUFFER TO BE COPIED BACK INTO THE TEXT WITH ├╧╬╘╥╧╠-Y (YANK).
  187.         ╥OT-13 REGION : ╨ERFORM THE ROT-13 TRANSFORMATION ON THE REGION  (WHICH
  188. MAPS EACH LETTER 13 POSITIONS AWAY; A-->M, B-->N, M-->A ETC)
  189.  
  190. 15.2  ┼XPANDED ├OMMAND ╥EFERENCE:
  191. (├-KEY - ├ONTROL+KEY    ┼-KEY - ╚IT ┼╙├ THEN KEY)
  192. ├-A      ═OVE THE CURSOR TO THE BEGINNING OF THE CURRENT LINE.
  193. ├-B      ═OVE THE CURSOR BACK ONE CHARACTER (SAME AS 'CURSOR LEFT')
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201. ╒NIX 128 V3.10 ═ANUAL           15 ╩ANUARY 1992                         ╨AGE 11
  202.  
  203.  
  204. ├-C      ├OPY THE CURRENTLY MARKED REGION INTO MEMORY, TO BE RETRIEVED WITH
  205.          ├-Y (YANK LINE)
  206. ├-D      ┼NTER ─ISK┼D, WHICH ALLOWS ├┬═ ─╧╙ COMMANDS TO BE EXECUTED.
  207. ├-E      ═OVE THE CURSOR TO THE END OF THE CURRENT LINE.
  208. ├-F      ═OVE THE CURSOR FORWARD ONE CHARACTER (='CURSOR RIGHT')
  209. ├-G      ╤UIT PROMPT (GENERAL ABORT FOR COMMANDS)
  210. ├-H      ╟ET ╚ELP!!!
  211. ├-K      ─ELETE LINE FROM CURSOR TO END OF LINE, COPYING THE LINE TO MEMORY.
  212. ├-L      ╥EDRAW THE SCREEN.
  213. ├-N      ═OVE THE CURSOR TO THE NEXT LINE (='CURSOR DOWN')
  214. ├-P      ═OVE THE CURSOR TO THE PREVIOUS LINE (='CURSOR UP')
  215. ├-R      ╥OT-13 A PREVIOUSLY MARKED REGION
  216. ├-V      ═OVE DOWN BY A FULL SCREEN
  217. ├-W      ╫RITE THIS FILE AS...
  218. ├-Y      ┘ANK A LINE FROM MEMORY TO THE CURRENT CURSOR POSITION.
  219. ├-X C    ├LEAR TEXT MEMORY.
  220. ├-X E    ├OPY THE KEYBOARD MACRO DEFINED WITH ├-( AND ├-)
  221. ├-X F    ╞IND PHRASE (MAYBE).
  222. ├-X I    ╔NSERT A FILE AT THE CURRENT CURSOR POSITION.
  223. ├-X P    ╨RINT THE CONTENTS OF MEMORY.
  224. ├-X S    ╙AVE FILE WITH CURRENT FILENAME.
  225. ├-X V    ╓IEW DOCUMENT WITH WORD-WRAP.
  226. ├-X ├-C  ╤UIT TO ╒NIX 128.
  227. ├-X ├-F  ╠OAD A FILE INTO MEMORY, ERASING CURRENT MEMORY CONTENTS.
  228. ├-X (    ╫RITE KEYBOARD MACRO
  229. ├-X )    ┼ND KEYBOARD MACRO
  230. ├-X =    ├URSOR INFORMATION (WHAT LINE, CHARACTER ETC)
  231. ├-X +    ╔NSERT A LINE AT THE CURSOR.
  232. ┼-<      ═OVE THE CURSOR TO THE BEGINNING OF THE FILE.
  233. ┼->      ═OVE THE CURSOR TO THE END OF THE FILE.
  234. ┼-V      ═OVE UP BY 1 FULL SCREEN.
  235. ┼-X ?    ╙HOW BOUND COMMANDS (NROFF HELP, FONTS ETC.)
  236.  
  237. ╧F COURSE, THE ABBREVIATED COMMAND REFERENCE MAY  BE  VIEWED  AT  ANY  TIME  BY
  238. TYPING ├-H, WITHOUT DISTURBING YOUR DOCUMENT.
  239.  
  240.  
  241. 16.  ╘HE TIP ╘ELECOMMUNICATIONS ╨ROGRAM.
  242.  
  243.      ╘IP IS USED TO CONNECT TO MAINFRAMES OR OTHER ╒NIX 128 SYSTEMS  USING  THE
  244. TELEPHONE  LINES.   ╔T CAN USE A WIDE VARIETY OF PROTOCOL AND TERMINAL SETTINGS
  245. AND WILL BE COMPATIBLE WITH MOST SYSTEMS.
  246.      ┴LL OF THE FEATURES OF TIP CAN BE ACCESSED  THROUGH  THE  MAIN  MENU.   ╘O
  247. BRING  UP  THE  MAIN MENU, PRESS THE ┴╠╘ KEY ON THE UPPER LEFT OF THE KEYBOARD.
  248. ╘HIS BRINGS UP THE FOLLOWING MENU HEIRARCHY (MAY NOT BE IN THE SAME ORDER):
  249.  
  250. 16.1  ╨ROTOCOL ═ENU:
  251.      -┬AUD ╥ATE:    THE SPEED OF COMMUNICATION (300 AND 1200 ARE MOST COMMON)
  252.      -─ATA ┬ITS:    7 OR 8 DATA BITS ARE SUPPORTED
  253.      -╨ARITY:       EVEN, ODD, SPACE, MARK OR NO PARITY ARE SUPPORTED
  254.      -╙TOP ┬ITS:    1 OR 2 STOP BITS ARE ALLOWED
  255.      -─UPLEX:       FULL(NO LOCAL ECHO) OR HALF(LOCAL ECHO) DUPLEX
  256. 16.2  ╘ERMINAL ╘YPE ═ENU:
  257.      -╓╘100:        USE ╓╘100 EMULATION.  ╞OR SOME REASON, NOT ALL OF THE CODES
  258.                      WORK ALL OF THE TIME.  ╚OPE TO HAVE THAT FIXED SOON....
  259.      -╓╘52:         USE ╓╘52 EMULATION.
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267. ╒NIX 128 V3.10 ═ANUAL           15 ╩ANUARY 1992                         ╨AGE 12
  268.  
  269.  
  270.      -├OMMODORE:    ALSO CALLED 'RAW' MODE, THIS DOESN'T INTERPRET ANY OF THE
  271.                      CONTROL CODES ENCOUNTERED.  ╘HIS IS USEFUL WHEN TALKING
  272.                      TO OTHER ├OMMODORE SYSTEMS.
  273. 16.3  ─IAL:
  274.        ┼NTER A PHONE NUMBER (NO PARENTHESES OR HYPHENS, A COMMA (,) MAKES A 2
  275.        SECOND PAUSE) AND TIP WILL DIAL IT AND ATTEMPT TO CONNECT.  ╧NE OF THE
  276.        THE FOLLOWING MESSAGES WILL BE RETURNED:
  277.          ├╧╬╬┼├╘       = CONNECTED AT 300 BAUD
  278.          ├╧╬╬┼├╘ 1200  = CONNECTED AT 1200 BAUD
  279.          ┬╒╙┘          = THE HOST IS BUSY
  280.          ╓╧╔├┼         = A HUMAN BEING ANSWERED THE PHONE.
  281. 16.4  ╚ANG ╒P ═ENU:
  282.          ╚ANG ╒P: OBVIOUSLY, HANG UP THE PHONE.
  283.          ─ON'T ╚ANG ╒P: OBVIOUSLY, DON'T HANG UP THE PHONE.
  284. 16.5  ├LEAR ─ISPLAY:
  285.          ╘HIS JUST CLEARS THE SCREEN.
  286. 16.6  ┬UFFER ═ENU:
  287.          ├APTURE ╧N:   ╘HIS WILL COPY EVERYTHING THAT COMES ACROSS THE SCREEN
  288.                         (EXCEPT MENUS ETC.) TO MEMORY
  289.          ├APTURE ╧FF:  ╘HIS TURNS OFF THE COPY-TO-MEMORY FEATURE.
  290.          ├LEAR ┬UFFER: ┼RASE ALL BUFFER MEMORY.
  291.          ╙AVE ┬UFFER:  ╙AVE THE CONTENTS OF THE BUFFER IN A DISK FILE.
  292.          ╨RINT ┬UFFER: ╨RINT THE CONTENTS OF THE BUFFER ON THE PRINTER.
  293.          ╓IEW ┬UFFER:  ╘YPE THE CONTENTS OF THE BUFFER ON THE SCREEN (USE THE
  294.                         ╬╧ ╙├╥╧╠╠ KEY TO PAUSE / RESUME.)
  295. 16.7  ┴╙├╔╔ ╒PLOAD:
  296.          ┼NTER A FILENAME AND TIP WILL JUST TYPE THE FILE TO THE MODEM.  ╘O
  297.          RECEIVE A FILE, YOU MUST FIRST TYPE:
  298.            ╓┴╪ / ╓═╙:  $ CREATE FILENAME  (WHEN UPLOAD IS DONE, TYPE ├╘╥╠-┌)
  299.            ╒NIX:       % CAT > FILENAME   (WHEN DONE, TYPE ├╘╥╠-─)
  300. 16.8  ╤UIT TO ╒NIX:
  301.          ╥ETURNS TO THE ╒NIX 128 SHELL PROMPT (%).  ┘OU CAN LEAVE TIP WITHOUT
  302.          HANGING UP, DO OTHER WORK, AND RETURN TO TIP SAFELY.  ╥EMEMBER TO HANG
  303.          UP THE PHONE WHEN YOU'RE ALL DONE (NOTE THAT SHUTTING OFF THE COMPUTER
  304.          WILL HANG UP THE PHONE AUTOMATICALLY)
  305. 16.9  (╘ERMINAL ═ODE):
  306.          ╥ETURN TO TERMINAL MODE WITHOUT DOING ANYTHING.
  307.  
  308.  
  309. 17.  DC:
  310.      DC IS THE  ╒NIX  128  DESKTOP  CALCULATOR.   ╔T  CAN  BE  USED  FOR  DOING
  311. ARITHMETIC  CALCULATIONS,  BASE CONVERSIONS AND TRIGONOMETRY.  DC CAN BE RUN IN
  312. ONE OF TWO MODES: INTERACTIVE AND SINGLE EXPRESSION.
  313.      ╔F YOU TYPE % DC AT THE SHELL PROMPT, DC WILL LOAD AND  PLACE  YOU  IN  AN
  314. INTERACTIVE ENVIRONMENT.  ╨RESSING '?' WILL LIST ALL OF THE FEATURES.
  315.      ╔F YOU TYPE % DC (EXPR) AT THE SHELL PROMPT (EXAMPLE:  % DC 3+2), DC  WILL
  316. BE  LOADED,  AND  IT  WILL EVALUATE THE GIVEN EXPRESSION, PRINT THE RESULT, AND
  317. RETURN TO THE SHELL IMMEDIATELY.
  318.      ╘HE VALID OPERATIONS ARE:
  319.           ╚ELP:       ?
  320.           ┴RITHMETIC: + - * /  ( ) !
  321.           ╞UNCTIONS:  (FUNCTIONS TAKE A SINGLE ARGUMENT)
  322.                       LOG SQR SQRT SIN COS TAN SEC CSC COT
  323.           ┴RGUMENTS:  CAN BE:
  324.                       -NUMERIC (EXAMPLE: 3+2)
  325.                       -E OR PI (DEFINED CONSTANTS)
  326.                       -ANS (ANS IS THE PREVIOUS ANSWER VARIABLE)
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333. ╒NIX 128 V3.10 ═ANUAL           15 ╩ANUARY 1992                         ╨AGE 13
  334.  
  335.  
  336.  
  337.           ├ONVERSION: HD (HEX ARG)    HEXADECIMAL TO DECIMAL
  338.                       HB (HEX ARG)    HEXADECIMAL TO BINARY
  339.                       DH (DEC ARG)DECIMAL TO HEXADECIMAL
  340.                       DB (DEC ARG)    DECIMAL TO BINARY
  341.                       BD (BIN ARG)    BINARY TO DECIMAL
  342.                       BH (BIN ARG)    BINARY TO HEXADECIMAL
  343.                 ┼XAMPLE:  TO CONVERT $FF TO DECIMAL, TYPE:  HD FF.
  344.  
  345. 18.  MAIL:
  346.  
  347. MAIL INVOKES THE ╒NIX 128 MAIL SYSTEM.  ╘HIS MAILER WAS SET UP SO THAT MULTIPLE
  348. USERS  OF  ╒NIX 128 ON A SINGLE SYSTEM COULD SEND MAIL BETWEEN EACH OTHER.  ╘HE
  349. OPERATION OF MAIL IS ALMOST EXACTLY IDENTICAL TO ┬ERKELEY MAIL (/USR/UCB/MAIL).
  350.      
  351. ╘HE MAILER USES 'MAILBOXES' NAMED USERNAME.MBOX; IF ONE DOESN'T EXIST  FOR  YOU
  352. IT  WILL  BE CREATED IF NEEDED.  ╔F YOU HAVE NO MAIL, MAIL WILL PROBABLY RETURN
  353. AN ERROR MESSAGE LIKE 'USER.MBOX DOESN'T EXIST.'.
  354.      
  355. MAIL CONTAINS ALL THE STANDARD ╒NIX MAILER COMMANDS: N (NEXT MESSAGE), S  (SAVE
  356. MESSAGE(S)), P (PRINT MESSAGE(S)), MAIL (MAIL TO ANOTHER USER), AND D (DELETE).
  357.  
  358.  
  359. 19.  SPREAD:
  360.      SPREAD IS THE ╒NIX 128 SPREADSHEET PROGRAM.  ╔T IS SIMILAR IN FUNCTION  TO
  361. ╠OTUS  1-2-3,  BUT  A  LOT  SMALLER  AND  SKIMPIER.   SPREAD PROVIDES A MAXIMUM
  362. SPREADSHEET SIZE OF 26 ROWS (┴-┌) BY 99 COLUMNS (1-99).  ╘HERE  ARE  FACILITIES
  363. FOR ENTERING TEXT STRINGS, NUMBERS, FUNCTIONS, AND MATH EXPRESSIONS.  ╞UNCTIONS
  364. AND MATH EXPRESSIONS MAY APPLY TO MULTIPLE CELLS ('RANGES').
  365.      ╔N MOST CASES, RANGES ARE ENTERED IN TWO WAYS:
  366.         -EXPLICITLY:  TWO OPPOSITE CORNERS (USUALLY TOP-LEFT AND  BOTTOM-RIGHT)
  367. ARE  GIVEN,  SEPARATED BY A HYPHEN (-).  ╘HE COLUMN LETTER MUST COME BEFORE THE
  368. ROW NUMBER.  ┼XAMPLE: A1-B10
  369.         -BY NAME:  COMMONLY USED RANGES MAY BE GIVEN A  NAME  (TYPE  ├╘╥╠-N  TO
  370. NAME  A  RANGE.)   ╧NCE  A  RANGE  IS  NAMED,  ITS NAME MAY BE GIVEN INSTEAD OF
  371. EXPLICITLY DEFINING THE RANGE.
  372.      ╔N SOME CASES (SUCH AS WHEN ENTERING A RANGE TO PRINT) YOU  CAN  ALSO  USE
  373. THE  CURSOR  KEYS  TO  SCROLL THE TOP LEFT CELL ADDRESS, PRESS '.', AND USE THE
  374. CURSOR KEYS TO SELECT A BOTTOM RIGHT CELL ADDRESS.
  375.      ╞UNCTIONS ACT ON RANGES.  ╞UNCTIONS ARE PRECEDED BY THE  '@'  SIGN.   ╙OME
  376. AVAILABLE  FUNCTIONS  ARE  SUM  (@SUM),  AVERAGE  (@AVG), MAXIMUM VALUE (@MAX),
  377. MINIMUM VALUE (@MIN), NUMBER OF NUMERIC ITEMS IN A RANGE  (@COUNT),  LOG,  SIN,
  378. COS,  TAN,  AND  SQRT  (SQUARE ROOT).  ╥ANGES ARE SPECIFIED AFTER THE FUNCTION:
  379. @SUM A1-B9.
  380.      ╙PREAD CAN ALSO CALCULATE BINARY MATH EXPRESSIONS  (EXPRESSIONS  WITH  TWO
  381. NUMBERS).   ═ATH  EXPRESSIONS  ARE  PRECEDED BY A PERCENT SIGN, CONTAIN A SINGE
  382. OPERATOR (+,-,* OR /), AND TWO ARGUMENTS (ARGUMENTS MAY BE  EITHER  NUMERIC  OR
  383. SINGLE CELL NAMES).  ┼XAMPLES:  %497-334  %A1-B1  %D49-10.
  384.      ╬╧╘┼:   ╞UNCTIONS  OR  EXPRESSIONS  THAT  ACT  ON  OTHER  CELLS  ARE   NOT
  385. AUTOMATICALLY CHANGED TO REFLECT CHANGES IN ARGUMENTS; A SCREEN REDRAW (├╘╥╠-R)
  386. WILL MAKE THESE CHANGES.
  387.      ├OMPLETE INFORMATION ON THE CURRENT VERSION  OF  SPREAD  IS  AVAILABLE  BY
  388. TYPING ├ONTROL-H.
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399. ╒NIX 128 V3.10 ═ANUAL           15 ╩ANUARY 1992                         ╨AGE 14
  400.  
  401.  
  402. 20.  ╧THER MISCELLANEOUS APPLICATIONS:
  403.  
  404. 20.1  ╟AMES:
  405.      ╞OUR 'GAMES' HAVE BEEN INCLUDED WITH ╒NIX 128:  BANNER, MAZE, PUZZLE,  AND
  406. WUMP (THESE ARE TRADITIONALLY FOUND IN /USR/GAMES ON "REAL" UNIX SYSTEMS.)
  407.      -┬ANNER WILL PRINT THE GIVEN PHRASE  IN  LARGE  LETTERS  ON  THE  STANDARD
  408. OUTPUT DEVICE.  ╘HUS, % BANNER I LOVE UNIX 128 ⌐ LPR   WILL PRINT A BIG SIGN ON
  409. YOUR PRINTER.
  410.      -═AZE CREATES A RANDOM MAZE AND PRINTS IT TO THE STANDARD OUTPUT.   ┴GAIN,
  411. YOU'LL PROBABLY WANT TO PIPE THIS COMMAND TO THE PRINTER.
  412.      -╨UZZLE IS A ╒NIX 128 IMPLEMENTATION OF THE SLIDING TILE GAME WHOSE OBJECT
  413. IS TO GET THE TILES IN NUMERICAL ORDER BY SLIDING THEM AROUND.
  414.      -╫UMP IS AN IMPLEMENTATION OF ╚UNT ╘HE ╫UMPUS, A GAME BY ╟REGORY ┘OB  THAT
  415. HAS  BEEN  ON  ╒NIX  SYSTEMS SINCE THEIR INCEPTION.  ╘HE OBJECT IS TO SHOOT THE
  416. ╫UMPUS WHILE AVOIDING HAZARDS LIKE PITS AND ╙UPERBATS.
  417.  
  418. 20.2  ╘AR:
  419.      ╘AR IS THE TAPE ARCHIVE PROGRAM THAT EXISTS TO  TAKE  MULTIPLE  FILES  AND
  420. CONCATENATE THEM INTO A SINGLE ARCHIVE FILE (CALLED A TARFILE) FOR ARCHIVING OR
  421. MAILING.  ╘HE ╒NIX 128 VERSION SEEMS TO BE COMPATIBLE WITH ╙UN'S  TAR  AND  ─┼├
  422. ╒LTRIX TAR.  ╧THER MAINFRAME ╒NIX TARFILES HAVE NOT BEEN TESTED.
  423.      ╘HE COMMAND LINE TO ARCHIVE MULTIPLE FILES INTO A SINGLE TARFILE IS:
  424.          % TAR -C [ TARFILE ] [ FILELIST...]
  425. AND THE COMMAND TO UNARCHIVE (E╪TRACT) A TARFILE IS:
  426.          % TAR -X [ TARFILE ].
  427.      ╘AR IS VERY SLOW IN EITHER ARCHIVING OR DE-ARCHIVING  FILES.   ┴LSO,  NOTE
  428. THAT  MAINFRAME-PRODUCED  TARFILES  WILL UNARCHIVE IN ┴╙├╔╔ FORMAT, NOT ├┬═╙├╔╔
  429. FORMAT, SO THAT ALL THE CASES WILL BE REVERSED (L╔╦┼ T╚╔╙).
  430.  
  431. 20.3  UUENCODE/UUDECODE:
  432.      ┴LSO IN THE AREA OF THINGS THAT ARE BINARY COMPATIBLE WITH ╒NIX MAINFRAMES
  433. ARE  UUENCODE  AND  UUDECODE.   ╒UENCODE  (PRONOUNCED YOU-YOU-ENCODE; SHORT FOR
  434. UNIX-TO-UNIX  ENCODE)  TAKES  AN  INPUT  FILE  AND  MAPS  ALL  THE   BYTES   TO
  435. ┴╙├╔╔-PRINTABLE  CHARACTERS.   ╘HE  ORIGINAL PURPOSE OF THIS WAS TO MAKE BINARY
  436. FILES (PROGRAMS) READABLE BY THE MAIL SYSTEM FOR FILE TRANSFERS.
  437.      ╘O ENCODE A FILE, TYPE %  UUENCODE  (-C)  INPUTFILE  OUTPUTFILE.   ╘HE  -C
  438. OPTION WILL CONVERT ┴╙├╔╔<>╨┼╘╙├╔╔ AS IT ENCODES.  ╘HE INPUTFILE IS THE FILE TO
  439. BE ENCODED, AND THE OUTPUTFILE IS THE ENCODED FILE.
  440.      ╘O DECODE A FILE, TYPE % UUDECODE  (-C)  FILENAME.   ╘HE  -C  OPTION  WILL
  441. CONVERT ┴╙├╔╔<>╨┼╘╙├╔╔ AS IT DECODES.
  442.  
  443. 20.4  STYLE:
  444.      STYLE WILL ANALYZE THE SURFACE CHARACTERISTICS OF THE WRITING STYLE  OF  A
  445. DOCUMENT.   ╔T  REPORTS  ON  READABILITY,  SENTENCE  LENGTH AND STRUCTURE, WORD
  446. LENGTH AND USAGE.  ╘HE GRADE IT GIVES IS SOMEWHERE AROUND 0-12, AND THE  HIGHER
  447. THE GRADE THE BETTER THE DOCUMENT.
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.